OPENCAP SEXP,VAR

 Function
  Open the screen capture file.

 Syntax
  OPENCAP file,stat

   file  - A string expression with the filename to open.
   stat  - A variable to hold the return status
           (TRUE if error opening file, FALSE otherwise).

 Remarks
  PCBoard has the ability to capture screen output to a file for later
  reference.  PPL allows that same ability via OPENCAP and CLOSECAP.
  This could be useful in a program that executes a series of commands
  in non-stop mode.  The process could open a capture file first, execute
  the commands, close the capture file, then allow the user to view or
  download the capture file.  CLOSECAP closes the capture file and turns
  off screen capturing.  Also, SHOWON and SHOWOFF can be used to turn on
  and off showing information to the screen while allowing that same
  information (even if not displayed or transmitted via modem) to be
  captured to a file.  SHOWSTAT() can be used to check the current status
  of SHOWON and SHOWOFF.

 Examples
  BOOLEAN ss
  LET ss = SHOWSTAT()
  SHOWOFF
  OPENCAP "CAP"+STRING(PCBNODE()),ocFlag
  IF (ocFlag) THEN
   DIR "U;NS"
   CLOSECAP
   KBDSTUFF "FLAG CAP"+STRING(PCBNODE())+CHR(13)
  ENDIF
  IF (ss) THEN
   SHOWON
  ELSE
   SHOWOFF
  ENDIF